ImageClip

Object Hierarchy | 関連する C++クラス:ImageClip2

継承

SIObject

ProjectItem

Clip

ImageClip

導入

v2.0

詳細

ImageClip オブジェクトはイメージSourceのインスタンスを表し、ディスク上に保存されているイメージへのリファレンスにもなります。イメージ クリップとイメージのソースは、イメージを FxTree に導入する手段、または Shader に影響を及ぼすテクスチャとして使用されます。イメージ クリップは AddImageClip または CreateImageClip を呼び出して作成します。

ファイルのパスや解像度などの重要な情報は、イメージSourceParameterとして保存され、Clip.Sourceを呼び出して取得します。イメージのピクセル値を読み取るには、ImageClip.GetImageを呼び出します。

メソッド

AddCustomOp AddProperty AddScriptedOp AddScriptedOpFromFile
AnimatedParameters2 BelongsToオペレータ EvaluateAt GetFileName
GetICEAttributeFromName GetImage GetScaledDownImage GetShaderParameterTargets
IsA IsAnimated2 IsClassOfオペレータ IsEqualToオペレータ
IsKindOf IsLockedオペレータ IsSelectedオペレータ LockOwners
SetAsSelectedオペレータ SetCapabilityFlagオペレータ SetLock TaggedParameters
UnSetLock      
       

プロパティ

Application BranchFlagオペレータ Capabilitiesオペレータ Categories
Effect EvaluationID Familiesオペレータ FullNameオペレータ
Help HierarchicalEvaluationID ICEAttributes LockLevelオペレータ
LockMastersオペレータ LockTypeオペレータ MappedItems Model
Nameオペレータ NestedObjects ObjectID Origin
OriginPath Owners PPGLayoutオペレータ Parametersオペレータ
Parent Parent3DObject Properties Relations
Selectedオペレータ Source TimeControl Typeオペレータ

1. VBScript の例

'
' This example illustrates how to create an ImageClip object and connect it 
' as the source of an image texture.
'
NewScene , false
set oImage = AddImageSource( "$SI_HOME\Data\XSI_SAMPLES\Pictures\jio.jpg" )
set oImageClip = AddImageClip( oImage )
set oSphere = ActiveSceneRoot.AddGeometry( "Sphere", "MeshSurface" )
set oMaterial = oSphere.AddMaterial("Phong")
set oPhong = oMaterial.Surface.Source
set oColor8Mix1 = oPhong.ambient.ConnectFromProgID("Softimage.sib_color_8mix.1")
set oColor8Mix2 = oPhong.diffuse.ConnectFromProgID("Softimage.sib_color_8mix.1")
set oTex2D = oColor8Mix1.color1.ConnectFromProgID("Softimage.txt2d-image-explicit.1")
call oColor8Mix2.color1.Connect(oTex2D)
set oTex2D.tex.Source = oImageClip

2. JScript の例

/*
        This example illustrates how to retrieve the image file name used for the texture of
        an object. It also illustrates how to retrieve the x and y resolution of that image.
*/
var oCube = CreatePrim("Cube", "MeshSurface", null, null);
ApplyShader(null, null, null, siUnspecified, siLetLocalMaterialsOverlap);
CreateProjection("cube", siTxtSpherical, siTxtDefaultSpherical, "", 
                        "Texture_Projection", null, siRelDefault, "");
BlendInPresetsInsp(null, null, null, true, siReplaceAndBlendInPreset, null, null, null, null);
var oImageClip = oCube.Material.CurrentImageClip;
var oImageSource = oImageClip.Source;
LogMessage("The image filename is " + oImageSource.Parameters("FileName").Value);
LogMessage("The image x resolution is " + oImageSource.Parameters("XRes").Value);
LogMessage("The image y resolution is " + oImageSource.Parameters("YRes").Value);
// Expected result:
//INFO : "The image filename is <$factory>\Application\rsrc\noIcon.pic"
//INFO : "The image x resolution is 256"
//INFO : "The image y resolution is 256"

関連項目

Image AddImageClip CreateImageClip ExportImageClip FxTree.AddImageClipOperator Scene.DefaultImageClip